home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / x00v150.zip / X00USER.DOC < prev    next >
Text File  |  1993-05-22  |  61KB  |  1,402 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                      USERS MANUAL
  27.  
  28.                   X.00 A Low Level Serial I/O Communications Driver
  29.                         for MS DOS and like Operating Systems.
  30.  
  31.                         Copyright (c) 1993 by Raymond L. Gwinn
  32.                                  12469 Cavalier Drive
  33.                               Woodbridge, Virginia 22192
  34.                                  All Rights Reserved
  35.  
  36.                                      May 22, 1993
  37.  
  38.  
  39.                      Fidonet address 1:265/104 (Routed mail only)
  40.                                  Compuserve 72570,157
  41.                           Internet 72570.157@Compuserve.com
  42.                                   Data 703-494-0098
  43.                                    FAX 703-494-0595
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                                                           i
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                      INTRODUCTION
  69.  
  70.           Previously,  the documentation  for X00  was little  more  than a
  71.           collection of notes.  The notes were added  to as the development
  72.           process continued and enhancements were made.  I honestly did not
  73.           suspect  that X00  would become as  widely used  as it  is.  This
  74.           manual is an attempt at some decent documentation for X00.
  75.  
  76.           But who  do I document  for?  The user  that is setting  up a BBS
  77.           just wants to get X00 installed  and to move on to more important
  78.           things.  The user that is having problems needs information about
  79.           serial  I/O communications  in general  and the  PC specifically.
  80.           The application developer (programmer) needs detailed information
  81.           about each individual function and the information generated.
  82.  
  83.           This manual is intended for the X00 user.  A separate Application
  84.           Programmers manual is being written.
  85.  
  86.           This manual and the software distributed with it is provided with
  87.           no guarantees.  Use at your own risk.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.                                                                          ii
  96.  
  97.                                   TABLE OF CONTENTS
  98.  
  99.  
  100.           WHAT IS X00 . . . . . . . . . . . . . . . . . . . . . . . . .   1
  101.  
  102.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  103.  
  104.           Licensing Information . . . . . . . . . . . . . . . . . . . .   2
  105.                Non-Commercial License . . . . . . . . . . . . . . . . .   2
  106.                Commercial License . . . . . . . . . . . . . . . . . . .   2
  107.                Commercial license fasttrack . . . . . . . . . . . . . .   4
  108.  
  109.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . .   5
  110.                Installing X00 . . . . . . . . . . . . . . . . . . . . .   5
  111.                Quick Start  . . . . . . . . . . . . . . . . . . . . . .   5
  112.  
  113.           OVERVIEW OF X00 USAGE . . . . . . . . . . . . . . . . . . . .   6
  114.                General Information  . . . . . . . . . . . . . . . . . .   6
  115.                     X00 loaded as a DOS Device Driver . . . . . . . . .   6
  116.                     X00 loaded as a TSR . . . . . . . . . . . . . . . .   6
  117.                     COMn and PORTn  . . . . . . . . . . . . . . . . . .   6
  118.  
  119.           COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   7
  120.                Specifying number of ports . . . . . . . . . . . . . . .   7
  121.                B option, Locking Baud, Data, Parity and Stop bits . . .   7
  122.                Valid locked baud rates  . . . . . . . . . . . . . . . .   8
  123.                Eliminate  . . . . . . . . . . . . . . . . . . . . . . .   8
  124.                Defer  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  125.                DV . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  126.                FIFO . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  127.                NOFIFO . . . . . . . . . . . . . . . . . . . . . . . .    10
  128.                NOPOST . . . . . . . . . . . . . . . . . . . . . . . .    10
  129.                R, Set Receive Buffer Size . . . . . . . . . . . . . .    10
  130.                T, Set Transmit Buffer Size  . . . . . . . . . . . . .    11
  131.                VP or Master Interrupt Enable  . . . . . . . . . . . .    11
  132.                Mapping port assignments . . . . . . . . . . . . . . .    11
  133.                Un-installing X00  . . . . . . . . . . . . . . . . . .    12
  134.  
  135.           Multi-Tasking . . . . . . . . . . . . . . . . . . . . . . .    13
  136.  
  137.           THE BIOS INT 14h EMULATOR . . . . . . . . . . . . . . . . .    15
  138.  
  139.           IRQ SHARING . . . . . . . . . . . . . . . . . . . . . . . .    16
  140.  
  141.           Appendix A, Hardware Port and IRQ Assignments . . . . . . .    17
  142.                Addresses and IRQs for COM1 and COM2 . . . . . . . . .    17
  143.                Defacto standard for COM3 and COM4 . . . . . . . . . .    17
  144.                Addresses and IRQ for COM3 through COM8 on the PS/2  .    17
  145.  
  146.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . .    18
  147.                8250 . . . . . . . . . . . . . . . . . . . . . . . . .    18
  148.                8250A  . . . . . . . . . . . . . . . . . . . . . . . .    18
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.                                                                         iii
  157.  
  158.                16450  . . . . . . . . . . . . . . . . . . . . . . . .    19
  159.                16C451 . . . . . . . . . . . . . . . . . . . . . . . .    19
  160.                16550 Non A  . . . . . . . . . . . . . . . . . . . . .    19
  161.                16550A . . . . . . . . . . . . . . . . . . . . . . . .    19
  162.                16550AF  . . . . . . . . . . . . . . . . . . . . . . .    19
  163.                16550AFN . . . . . . . . . . . . . . . . . . . . . . .    19
  164.                16550s Made by Western Digital . . . . . . . . . . . .    20
  165.                16C551 . . . . . . . . . . . . . . . . . . . . . . . .    20
  166.                16C552 . . . . . . . . . . . . . . . . . . . . . . . .    20
  167.                82510  . . . . . . . . . . . . . . . . . . . . . . . .    20
  168.  
  169.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . .    21
  170.                Connect-Com 4  . . . . . . . . . . . . . . . . . . . .    21
  171.                4 and 8 Port Boards from Decision-Computer . . . . . .    21
  172.                Stargate Plus 8 board from Software Link . . . . . . .    22
  173.  
  174.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .    23
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                                                           1
  183.  
  184.                                      WHAT IS X00
  185.  
  186.           X00 is  a Serial Input/Output  (SIO) communications  driver.   It
  187.           provides  an interface  between  an application  program and  the
  188.           serial communications hardware.
  189.  
  190.           X00 was  originally designed as  a FOSSIL  driver.  FOSSIL  is an
  191.           acronym containing the first  character of several communications
  192.           programs.   The FOSSIL specification is basically an extension of
  193.           the PC's BIOS services for serial communications.
  194.  
  195.           Except as noted in  the Programmers Manual, X00 meets  the FOSSIL
  196.           level 5  specification.   X00 provides additional  functions that
  197.           are not contained in the FOSSIL level 5 specification.
  198.  
  199.           X00 only works with 8250 (TYPE) serial I/O devices.  Such devices
  200.           include the 8250A,  16450, 16550, 16550A and  the 82510.   If you
  201.           have a PC that  is an IBM or  near compatible which has  a serial
  202.           communication  port, it is likely  that it contains  one of these
  203.           devices.  XU, a  utility distributed with X00, will  identify the
  204.           existence of compatible SIO devices.
  205.  
  206.           Like  other  Device Drivers,  X00  will do  very  little standing
  207.           alone.  There must be an application(s) program to use X00 before
  208.           you will gain benefit.
  209.  
  210.           Since  the introduction  of the  FOSSILs, a  great number  of new
  211.           communications  programs have  come into  existence.   I like  to
  212.           think  that the FOSSILs are  l